home *** CD-ROM | disk | FTP | other *** search
/ 3D GFX / 3D GFX.iso / amiutils / e_h / getscreenid / gsi.doc < prev    next >
Text File  |  1995-12-30  |  8KB  |  231 lines
  1.           #############################################################
  2.  
  3.                                  GetScreenID 1.2
  4.  
  5.                          Written by GONCALVES A. Georges
  6.  
  7.                Copyright ⌐ 1994 by GONCALVES A. Georges ( Melkor )
  8.                                All rights reserved
  9.  
  10.           #############################################################
  11.  
  12.  
  13.  
  14.                                    User manual
  15.  
  16.                                        of
  17.  
  18.                                    GetScreenID
  19.                                    version 1.2
  20.  
  21.  
  22.                                    * Sommary *
  23.  
  24.  
  25.                         1 - Disclaimer
  26.                         2 - Distribution
  27.                         3 - Introduction
  28.                         4 - Requirements
  29.                         5 - Usage
  30.                         6 - Hints and Tips
  31.                         7 - Acknowledgements
  32.                         8 - History
  33.                         9 - Contacting author
  34.  
  35.  
  36.   1 - Disclaimer :
  37.   ----------------
  38.  
  39.   The author is not responsible for any damage caused directly  or  indirectly
  40.   by  the  use  of this program. If your monitor explode, your hardisk crashed
  41.   and no more formatable, your 680x0 changed in an Intel type processor or the
  42.   FPU gives results like 1/1 = 0.999999956784 its not my fault.
  43.   Use it at your own risk.
  44.  
  45.  
  46.   2 - Distribution :
  47.   ------------------
  48.  
  49.   You can distribute it as long as you don't make money with it :(  It's NOT
  50.   public domain but freely distribuable. Really, it's a CardWare program. That
  51.   means if you enjoy and use it, you have the moral obligation to send me a
  52.   postal card of your city or country, not so expensive I think ;-)
  53.  
  54.  
  55.   3 - Introduction :
  56.   ------------------
  57.  
  58.   Have you never been annoyed when you want to display a  picture,  with  your
  59.   favourite  viewer,  in  a different screenmode than the one specified in the
  60.   picture file and your viewer asks for a display ID or the string name of the
  61.   screenmode instead of opening a ScreenModeRequester like the Asl or Reqtools
  62.   ones ? Sure yes ! Don't you think that is very boring to type something like
  63.   "PAL:High  Res  no  flicker"  every  time  you  want  it.  This  string only
  64.   represents the DisplayID  of  a  ScreenMode  and  its  better  to  choose  a
  65.   ScreenMode in a requester, isn't it ? That's the job of GetScreenID. It
  66.   works similary to those GetPubName programs.
  67.  
  68.  
  69.   4 - Requirements :
  70.   ------------------
  71.  
  72.   You must have some little things in order to get GSI to work :
  73.  
  74.     - Reqtools.library V38 or better
  75.     
  76.     - a little Shell knowledge ( very little )
  77.     
  78.     - an Amiga ( GSI is useless on PCs as Screens don't exists ;-> )
  79.  
  80.     - You must hate MicroSoft Windows ;-)
  81.  
  82.  
  83.   5 - Usage :
  84.   -----------
  85.  
  86.   Here is the HARDER part ( joke ! )
  87.  
  88.   From Workbench : Doubleclick it and you'll have a ScreenModeRequester.
  89.                    Choose the Mode and a Requester will show you the
  90.                    appropriate DisplayID. Workbench use is most for info
  91.                    purpose.
  92.  
  93.   From Shell     : Type GSI and you'll get the ScreenModeRequester. When
  94.                    selected the DisplayID is inserted in the command line
  95.                    so you can use it as follows :
  96.  
  97.                    PicViewer Pics:BeautyfullGirl SCREENMODE=`GSI`
  98.  
  99.                    and your PicViewer will receive as argument :
  100.  
  101.                    PicViewer Pics:BeautyfullGirl SCREENMODE=A9004
  102.  
  103.                    for "PAL:High Res No Flicker".
  104.  
  105.                    For BAD :-) programs like ViewTek (joke :) which does
  106.                    not accept DisplayIDs but wants the user to type the
  107.                    complete name of ScreenMode, I've included the option
  108.                    NAME/S so you can use it as follows:
  109.  
  110.                    ViewTek Pics:BeautyfullGirl SCREENMODE=`GSI NAME`
  111.  
  112.                    and your ViewTek will receive as argument :
  113.  
  114.                    ViewTek Pics:BeautyfullGirl SCREENMODE="PAL:High Res No Flicker"
  115.  
  116.   Can it be easier ?
  117.  
  118.  
  119.   6 - Hints ans tips :
  120.   --------------------
  121.  
  122.   GSI has some features that can be transparent for a normal user and usefull
  123.   for experienced ones and vice-versa.
  124.  
  125.   o The requesters appear on the frontmost public screen.
  126.  
  127.   o if the program that requires the DisplayID wants a 'C' formated hex number
  128.     just add the 'C' prefix for a hex number : 0x or 0X
  129.  
  130.     ex:  PicViewer Pics:BeautyfullGirl SCREENMODE=0x`GSI` or ...MODE=0X`GSI`
  131.  
  132.     to   PicViewer Pics:BeautifullGirl SCREENMODE=0xA9004 or ...MODE=0XA9004
  133.  
  134.   o If you enter 'GSI ?', you'll get the standard ReadArgs() template like
  135.     > GSI ?
  136.     NAME/S: 
  137.     Entering another '?' at this point will give you a little description
  138.     of GSI's job.
  139.  
  140.  
  141.     Known bugs:
  142.     -----------
  143.     IT'S NOT A BUG,simply a misfeature. When you use :
  144.     GSI NAME, if the name is not localized in the ScreenMode requester,
  145.     the name inserted in the command line will be -> "" instead of
  146.     -> "Mode: mode description". It's not my fault but the
  147.     GetScreenInfoData() does not fill the NameInfo structure for
  148.     this types of ScreenModes. If someone as a solution, please
  149.     tell me.
  150.     
  151.  
  152.  
  153.   7 - Acknowledgements :
  154.   ----------------------
  155.  
  156.   GSI has been created using SAS/C 6.51 ( Poor guys on PCs with Borland  C  :-)
  157.   It  was linked with the TinyStartup lib ⌐ StΘphane BUNEL ( TinyStartup is the
  158.   MUI of startups, it controls all for you and so simple to use ( even  a  BABY
  159.   can  program  with  it  ! ). Edition by GoldED ( Only Dietmar Eilert makes it
  160.   possible ) on OS 3.x Kickstart 40.70, Workbench 40.42 ( What a wonderfull  OS
  161.   ! ). Documentation was a piece of cake with the ( buggy but cool ) AGWritter.
  162.   Of course, only an Amiga can run this thingies ( Thanks to the engineers  for
  163.   making a so wonderfull computer ).
  164.  
  165.   and now the friends...
  166.  
  167.  
  168.   StΘphane Bunel : Katov
  169.                    TinyStartup is now really good and reliable. no more 'c.o'.
  170.                    'Amiga for ever and PC for Lamer...'
  171.  
  172.   Pascal Lauly :
  173.                  Aminet Master ! where is the xpkJVRO.library ??? I want It now :)
  174.  
  175.   Nicolas Frank : Gryzor
  176.                   My loved GryGry, I haven't seen you for ages !!!
  177.                   We must change that !
  178.  
  179.   Christophe Paoutoff : Showgger
  180.                         Hello 'ChojΘ', GSC is the best CPU board ever made.
  181.                         4 CPUs, 3 CoPros and NO hardware needed :-)
  182.                         That's the Exec's fault !!!!
  183.  
  184.   Olivier Laudren : Cople
  185.                     RayTracing master !!! How are you my friend ?
  186.  
  187.   Nicolas Frank : Gryzor
  188.                   ProWizard et DeliWizard are the ProTracker rulers !!!
  189.  
  190.   Kersten Emmrich : Emmy
  191.                     33MHz ist nein genug, 40MHz ist gut !!!
  192.   
  193.   Magnus Holmgren :
  194.                     Hello to my friend, the swedish knight :)
  195.  
  196.   Federico Giannici :
  197.                       impossible to live without CycleToMenu !!!
  198.  
  199.   Albert Schweizer :
  200.                      I'm glad you accepted my French catalog for Yass.
  201.                      It's a wonder... wonderfull Yass :-)
  202.  
  203.   and many others I forgot, sorry :(
  204.  
  205.  
  206.   8 - History :
  207.   -------------
  208.  
  209.     1.0  -  INTERNAL RELEASE
  210.  
  211.     1.1  -  First public release. Worked well and not so big with TinyStartup :-)
  212.  
  213.     1.2  -  Added the NAME/S option for ViewTek style programs :-) (Hi Thomas)
  214.             Enforcer + SegTracker hits free !!!
  215.  
  216.   9 - Contacting the author :
  217.   ---------------------------
  218.  
  219.   I can be reached at :
  220.  
  221.     Goncalves A. Georges
  222.     27, rue Morand
  223.     75011 Paris
  224.     FRANCE
  225.  
  226.   Sorry, no E-Mail address ( not yet :) .
  227.  
  228.  
  229.  
  230.  
  231.